home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / modula.zoo / __read.me < prev    next >
Text File  |  1988-06-07  |  6KB  |  146 lines
  1. -------------------------------
  2. Dokumentation zum Modula-System                         Stand 17.5.88
  3. -------------------------------
  4.  
  5. 1.0 Zusammenstellen der Disketten :
  6. -----------------------------------
  7. Da die Disk-Kapazität begrenzt ist, ist es sinnvoll mit 2 Disketten
  8. zu arbeiten.
  9.  
  10. 1) STARTDISK :
  11.    benötigt
  12.         - AUTO   (Ordner)
  13.         - GEMLIB (Ordner)
  14.         - STDLIB (Ordner)
  15.         - SYSTEM (Ordner)
  16.         - COPY.LST    ( Liste der Files die in die Ramdisk überspielt werden ) 
  17.         - DEBUG.RSC
  18.         - EDITOR.PRG  ( eigener Editor )
  19.         - ERROR.IND   ( Fehlermeldungen für Compiler )
  20.         - M2PATH.TXT  ( Suchpfade der MODULA-SHELL )
  21.         - NEWSHELL.RSC
  22.     sinnvoll ist es außerdem die SDM-Files (= SYMBOL-DEFN-Files die
  23.     die zum compilieren benötigt werden in die RAM-Disk in den Ordner SBM
  24.     zu legen.)
  25.  
  26. 2) ARBEITSDISK :
  27.    benötigt
  28.         - DEFN  ( Ordner nur mit .DEFN - Files )
  29.         - WORK  ( leerer Ordner zum compilieren & arbeiten ) 
  30.         - STANDALONE ( wird nur benötigt, wenn .PRG - Files codiert werden
  31.                        siehe auch unter Punkt 3.2 ) 
  32.  
  33. 2. Modula-Shell :
  34. -----------------
  35.  
  36. 2.1 Hochfahren des Systems
  37.  
  38. - ATARI einschalten
  39. - START Diskette einlegen
  40.   ... Der ATARI bootet und installiert die RAM - Disk
  41.   dies bestätigen Sie mit RETURN
  42.   ... Einige Files (auch EDITOR.PRG !) werden in die RAM - Disk geladen
  43.   Nun können Sie die für ihr Programm nötigen SBM-Files in die
  44.   RAM-Disk kopieren (Das compilieren geht wesentlich schneller)
  45.   Jetzt wird der M2LOADER durch Sie auf der RAM-DISK gestartet.
  46.   Im LOADER starten Sie M2SHELL.OBM durch betätigen der RETURN-Taste.
  47.   ...Die Modula-Shell wird nun geladen.
  48.   Jetzt müssen Sie nur noch das DATUM eingeben, falls dies noch nicht
  49.   geschehen ist und schon kann's losgehen.
  50. - ARBEITSDISK ins Laufwerk 
  51.   und ran an die Arbeit.
  52.  
  53.   Nun können Sie ein Programm übersetzen, indem Sie unter Datei
  54.   übersetzen ( Erzeugung eines CodeFiles  .OBM) oder
  55.   PRG erzeugen (Erstellen eines direkt lauffähigen Programms, siehe auch 3.2)
  56.   anwählen.
  57.  
  58.  
  59. Zusätzliche Hinweise :
  60.  
  61. Um in der Shell die Editierfunktion benützen zu können,
  62. müssen Sie den Namen eines Textverarbeitungsprogrammes oder
  63. Editors (z.B. Tempus, ... )  auf EDITOR.PRG ändern und 
  64. dieses File auf die Compiler-Diskette bzw. die START-DISK  kopieren.
  65.  
  66.  
  67. 3.0 Informationen über M2SHELL / MODULA-Comliler :
  68. --------------------------------------------------
  69.  
  70. 3.1 allgemeines:
  71.  Die Arbeitsumgebung ist in Schalen aufgebaut. Unterste Schale ist
  72. der M2Loader. (In Wirklichkeit liegt da noch so einiges an Be-
  73. triebssystem, GEM etc. drunter, das ist immer da und interessiert 
  74. uns nicht weiter.) Auf M2Loader liegt dann M2Shell. Dies ist ein 
  75. nicht gelinktes Objetmodul d.h. es kann nicht ohne denM2Loader 
  76. laufen. M2Shell ruft dann ihrerseits Editor und Compiler auf.
  77. Wird ein compiliertes Programm gestartet so läuft es, wenn es 
  78. noch nicht gelinkt ist, wie alle .OBM Programme unter Kontrolle 
  79. von M2LOADER, der bei Laufzeitfehlern den Debugger starten kann. 
  80. M2SHELL, der Compiler und der Debugger bleiben wenn sie 
  81. einmal geladen sind resident. 
  82.  
  83. Um dem Benutzer das Leben zu erleichtern gibt es die Datei 
  84. M2PATH.TXT. Diese Datei kann wie jede Textdatei mit dem Editor 
  85. bearbeitet werden. In ihr stehen Suchpfade die der Compiler, der 
  86. Debugger und M2LOADER auf der Suche nach Dateien benutzen. Außer-
  87. dem kann der Defaultaufruf des M2LOADER eingetragen werden. D.h. 
  88. der Name der in der letzten Zeile nach @M steht kann durch an-
  89. klicken von "O.K" gestartet werden. 
  90. In der vorletzten Zeile dieser Datei steht der Suchpfad, der als 
  91. Default für für Funktionen wie Modul auswählen verwendet wird.
  92.  
  93.  
  94. 3.2 stand-alone Programme:
  95.  Da man, wenn man "ernsthaft" programmieren will Programme ohne 
  96. den Schutz von M2LOADER laufen lassen will muss man die compi-
  97. lierten Objektmodule binden (linken). Dazu muß sich der Ordner 
  98. STANDALO.NE auf dem Laufwerk befinden, von dem M2LOADER geladen 
  99. wurde, d.h. Benutzer einer RAM-Disk müssen diesen Ordner samt Inhalt
  100. per Maus, oder per COPY.LST automatisch in die Ramdisk kopieren.
  101. Der Linker wird durch "PRG erzeugen" gestartet. Er sucht sich 
  102. dann alles zusammen, was er braucht (LINKER.OBM,PATH.OBM,HEAP.OBM,...)
  103. linkt dann ein lauffähiges .PRG-File aus allen nötigen .OBM-Files
  104. (Diese müssen dann auch vorhanden sein oder per Hand von anderen Disks
  105. angewählt werden !!!) zusqammen und überprüft auf Versionskonflikte. 
  106. Findet er etwas nicht, so gibt er dem Benutzer die 
  107. Chance per "Hand" die gesuchten Module zu finden.
  108.  
  109. 3.3 Der Debugger
  110. Wie der Compiler stammt auch der Debugger aus dem Geburtsort von 
  111. Modula-2, aus der ETH Zürich. Der Debugger ist ein symbolischer 
  112. Post-Mortem-Debugger. Das heist er wird nach einem Laufzeitfehler 
  113. vom M2LOADER gestartet und zeigt nicht irgendwelche Speicherin-
  114. halte sondern verwendet die Programmsource. Die Fehlerzeile ist 
  115. fett gedruckt. Alle beim Fehlerauftritt sichtbaren Variablen kön-
  116. nen angezeigt weden. Es gibt fünf Fenster:
  117.  
  118. - Quelltext:
  119. Da steht (hoffentlich) der Quelltext drin in dem der Fehler auf-
  120. trat. Wenn nichts drin steht fehlt der Quelltext. Wenn der Quell-
  121. text in einem der Suchpfade liegt führt das Anklicken des Modul-
  122. namens im Modulfenster (meistens) zum Erfolg.
  123.  
  124. - Prozeduraufrufkette und Datenfenster 1:
  125. Dies beiden Fenster gehören zusammen. Das linke Fenster (Proze-
  126. duraufrufkette) zeigt in welcher Reihenfolge die Prozeduren auf-
  127. gerufen wurden. Da stehen auch die Prozeduren des M2LOADER drin.
  128.  
  129. - Modulliste und Datenfenster 2:
  130. Hier gilt gleiches wie oben, nur daß hier Module angezeigt werden 
  131. und die dort sichtbaren Variablen.
  132.  
  133. Durch anklicken von Prozedur/Modulnamen kann man dies Proze⑨
  134. dur/Modul betrachten.
  135.  
  136. Zu den Datenfenstern ist die Darstellung der Arrays und der 
  137. Records zu erwähnen. Beide sind durch "*" gekenzeichnet. Klickt 
  138. man diesen an "betritt" man das Array/Record. In der ersten Zeile
  139. des Fensters erscheint nach einem "." der Name der angeklickten 
  140. Variablen. Bei tiefer struckturierten Datentypen können dort 
  141. durchaus mehrer Bezeichner durch "." getrennt hintereinander 
  142. stehen. Durch Anklicken der Bezeichner kann man wieder "herauf" 
  143. steigen.
  144.  
  145.  
  146.